home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / asmutil / tbones07.zip / TBONES07.DOC < prev    next >
Text File  |  1991-01-20  |  18KB  |  405 lines
  1. ***************************************************************************
  2. *                                      *
  3. *                             T-BONES                                     *
  4. *                           Version 0.7                                   *
  5. *                         January 20, 1991                                *
  6. *                                                                         *
  7. *       SKELETAL ASM PROGRAMS TO HELP IN PROGRAMMING YOUR OWN TSRs        *
  8. *                                      *
  9. *             Copyright (C) 1990, 1991 by Robert Curtis Davis             *
  10. *                                                                         *
  11. *      Internet E-mail address: sonny@trantor.harris-atd.com           *
  12. *                                                                         *
  13. *                         US Mail: 430 Bahama Drive                       *
  14. *                                  Indialantic, FL 32903                  *
  15. *                                      *
  16. ***************************************************************************
  17.  
  18. ONE-LINE DESCRIPTION:
  19. --------------------
  20.         TBONESxx.ZIP - Skeletal ASM programs for your own TSRs.
  21.  
  22. ***************************************************************************
  23.  
  24. DISCLAIMER:
  25. ----------
  26.     T-BONES is currently under development and this is a preliminary
  27. version. This software is not warranted to be suitable for any purpose and
  28. the author will not be held responsible for any damages arising directly or 
  29. indirectly from its use. By the act of using this software, the user agrees 
  30. to these conditions.
  31.  
  32. ***************************************************************************
  33.  
  34. DESCRIPTION:
  35. -----------
  36.     T-BONES is a set of skeletal Assembly Language programs which
  37. can be used as starting points in developing Terminate-but-Stay-
  38. Resident (TSR) programs for your DOS computer.
  39.  
  40.  
  41. BACKGROUND:
  42. ----------
  43.     In examining some software packages useful in learning about TSRs,
  44. I couldn't seem to find one that provided skeletal ASM programs into
  45. which I could easily drop my own Interrupt-triggered or Hot Key-triggered
  46. routines. It was toward the provision of these bare-bones programs which
  47. had already taken care of all the various details (initialization, saving
  48. old interrupt vectors, installing new interrupt vectors, going resident,
  49. determining if DOS code was interrupted, determining if DOS is at
  50. "Busy idle", determining if the TSR is already installed, etc.) necessary
  51. in some TSRs, that I undertook the writing of the programs in T-BONES
  52. as an aid to my own TSR programming efforts.
  53.     Also, I recognized that not all the features enumerated are
  54. necessary in every TSR. For example, if you are not going to use
  55. DOS calls in your routine, checking to be sure DOS is at idle may be
  56. unnecessary. Therefore, I have included TSRINT and TSRKEY which are
  57. very simple and leave it up to you to stay out of DOS's way.
  58.     Anyway, it is my hope, based upon feedback from users, to provide 
  59. a set of useful skeletal TSR Assembly Language programs that
  60. make it relatively easy for programmers to drop their own routines
  61. into place without having to start all over from scratch on every TSR.
  62.  
  63. ------------------------------------------
  64. PERMITTED DISTRIBUTION AND USAGE OF TBONES:
  65.  
  66.         No current restrictions are placed on the distribution either of the
  67. TBONES package itself (please pass it on to anyone who might use it) or on TSRs
  68. you might develop using this TBONES software package. But please leave
  69. somewhere in your program an acknowledgement of TBONES' help in making the
  70. TSR. Other than that, feel free to modify the ASM file (filename, comments,
  71. output messages, TSR signature, etc.) to make it "look" and "feel" as you
  72. wish.
  73.  
  74. ------------------------------------------
  75. TBONES' COST:
  76.  
  77.         I presently ask only that you send me (preferably by E-mail) a free
  78. copy of any generally-useful TSR that you develop using TBONES. That way,
  79. I am paid in useful software only if TBONES itself proves genuinely useful
  80. to you.
  81.  
  82. ------------------------------------------------------------------------------
  83.  
  84.  
  85.     T-BONES currently consists of:
  86.  
  87.         (1) README:
  88.                 Quick start information. Read this to find out if TBONES
  89.                 might be of use to you.
  90.  
  91.         (2) TBONES07.DOC:
  92.                 This complete documentation file.
  93.  
  94.         (3) TSRINT.ASM:
  95.                 Assembly Language skeletal program for use in
  96.                 developing a TSR program that is triggered into
  97.                 action by "Hooking" to a user-specified Interrupt.
  98.                 Raw program with NO features to keep you out of
  99.                 trouble with DOS nonreentrancy.
  100.  
  101.         (4) TSRINT.COM:
  102.                 Executable Hooked Interrupt TSR code obtained by
  103.                 assembling TSRINT.ASM (with MASM), linking (with DOS'
  104.                 LINK), and conversion from .EXE to .COM form using DOS'
  105.                 EXE2BIN. The commands necessary to convert TSRINT.ASM
  106.                 to TSRINT.COM are:
  107.  
  108.                         MASM TSRINT;
  109.                         LINK TSRINT;     (Ignore the No Stack warning)
  110.                         EXE2BIN TSRINT TSRINT.COM
  111.  
  112.                 Or, if working with Borland's TASM package:
  113.                         TASM /ml TSRINT
  114.                         TLINK /x/t TSRINT
  115.  
  116.         (5) TSRKEY.ASM:
  117.                 Assembly Language skeletal program for use in
  118.                 developing a TSR program that is triggered into
  119.                 action by a user-specified "Hot Key" combination.
  120.                 Raw program with NO features to keep you out of
  121.                 trouble with DOS nonreentrancy.
  122.  
  123.         (6) TSRKEY.COM:
  124.                 Executable HotKey TSR code obtained by assembling
  125.                 TSRKEY.ASM (with MASM), linking (with DOS' LINK), and
  126.                 conversion from .EXE to .COM form using DOS'
  127.                 EXE2BIN. The commands necessary to convert TSRKEY.ASM
  128.                 to TSRKEY.COM are:
  129.  
  130.                         MASM TSRKEY.ASM;
  131.                         LINK TSRKEY.OBJ;
  132.                         EXE2BIN TSRKEY.EXE TSRKEY.COM
  133.  
  134.                 Or, if working with Borland's TASM package:
  135.                         TASM /ml TSRKEY
  136.                         TLINK /x/t TSRKEY
  137.  
  138.  
  139.         (7) TSRBONES.ASM:
  140.                 TSRBONES is the flagship program in this package.
  141.                 It is an Assembly Language skeletal program for use in
  142.                 developing a TSR program that is triggered into
  143.                 action by a user-specified "Hot Key" combination
  144.                 WHEN DOS IS AT "BUSY IDLE" Int 28h. When DOS is
  145.                 at "Busy Idle", it is safe to use DOS Function calls
  146.                 ABOVE 0Ch without incurring problems with DOS'
  147.                 non-reentrancy. The code also prevents multiple
  148.                 installations. The TSR also will not trigger if the CPU
  149.                 is busy servicing a hardware interrupt (IRQ0 - IRQ7).
  150.  
  151.         (8) TSRBONES.COM:
  152.                 Executable HotKey "DOS-OK" TSR code obtained by
  153.                 assembling TSRBONES.ASM (with MASM), linking (with
  154.                 DOS' LINK), and conversion from .EXE to .COM form
  155.                 using DOS' EXE2BIN. The commands necessary to convert
  156.                 TSRBONES.ASM to TSRBONES.COM are:
  157.  
  158.                         MASM TSRBONES.ASM;
  159.                         LINK TSRBONES.OBJ;
  160.                         EXE2BIN TSRBONES TSRBONES.COM
  161.  
  162.                 Or, if working with Borland's TASM package:
  163.                         TASM /ml TSRBONES
  164.                         TLINK /x/t TSRBONES
  165.  
  166.         (9) HISTORY:
  167.                 The revision history for the TBONES package.
  168.  
  169. ******************************************************************************
  170.  
  171. ASSEMBLERS:
  172.  
  173.         The following assemblers are known to successfully assemble the
  174.         ASM files in TBONES:
  175.  
  176.                 - ARROWSOFT Public Domain Assembler v1.00d (64K Model)
  177.                 - MASM v1.0 and v4.00
  178.                 - TASM v1.00
  179.  
  180. ********************************************************************